N4 has implemented a framework for shifting XPS vessel, rail, and gate move processing to N4 to minimize the load on the XPS server. This is the default behavior as of 3.9. However, if there are issues with this N4 processing, it's possible to roll back it back to XPS. The following table shows what you need to do to roll back each individual process. See How N4 move processing APIs map to old XPS Bento calls (on page 1).
|
Process |
Roll back procedure |
|---|---|
|
Hatch Clerk vessel discharge decking requests |
Set ARGOBENTO002 (on page 1) from N4 to XPS_SERVER |
|
Hatch Clerk vessel load requests |
Set ARGOBENTO003 (on page 1) from N4 to XPS_SERVER |
|
Hatch Clerk vessel shift-on-board requests |
Set ARGOBENTO004 (on page 1) from N4 to XPS_SERVER |
|
Hatch Clerk crane activity recording |
Set ARGOBENTO005 (on page 1) from N4 to XPS_SERVER |
|
Discharge move completion |
Set ARGOBENTO002 (on page 1) from N4 to XPS_SERVER In ECN4 ecn4_settings.xml, modify the following snippet to value = "false" <component name="n4completion"> <setting name="N4_MOVE_COMPLETION" value="true"/> </component> |
|
Get Next Load Position Request |
Set ARGOBENTO017 (GET_NEXT_LOAD_POSITION_BENTO_PROCESSING) (on page 1) to XPS_Server to process N4 Crane Automation Get Next Load Position requests using Bento 20016 instead of processing on N4. |
|
Rail Load Processing |
Set ARGOBENTO006 (RAIL_LOAD_BENTO_PROCESSING) (on page 1) to XPS_SERVER. |
|
Rail Discharge Processing |
Set ARGOBENTO007 (RAIL_DISCHARGE_BENTO_PROCESSING) (on page 1) to XPS_SERVER. |
|
Revert Plan |
Cannot be rolled back to XPS 21015. |
|
Gate receivals for pre-advised containers |
Set ROADGATE037 to XPS. |
|
IFT unit planning processing |
To roll back to the 20011 Bento, set ARGOBENTO014 (PLAN_IFT_UNIT_BENTO_PROCESSING) (on page 1) to XPS_Server. |
|
Gate equipment selection processing |
To roll back to the 20002 Bento, set ARGOBENTO008 (EQUIPMENT_SELECTION_BENTO_PROCESSING) (on page 1) to XPS_SERVER |
|
Exchange Lane update processing |
To rollback to the 20004 Bento, set ARGOBENTO010 (EXCHANGE_LANE_UPDATE_BENTO_PROCESSING) (on page 1) to XPS_Server.) |
|
Work Instruction update processing |
To rollback to the 20005 Bento, set ARGOBENTO011 (on page 1) to XPS_Server |
|
Outgate processing |
To rollback to the 20014 Bento, set ARGOBENTO015 (OUT_GATE_BENTO_PROCESSING) (on page 1) to XPS_Server. |
|
Gate delivery plan processing |
To rollback to the 20003 Bento, set ARGOBENTO009 (PLAN_DELIVERY_BENTO_PROCESSING (on page 1) to XPS_Server |
|
Set Stack Status |
To rollback to the 21004 Bento: Set the ECN4 setting setstackstatusstream to "false" in the ecn4_settings.xml file: <component name="setstackstatusstream"> <setting name="ENABLED" value="false"/> </component> |
|
Swap Position
|
To roll back to the 21008 Bento: Under ecn4-extensions\sample\xpsRevertPlan, copy the xpsRevertPlan.jar and place it directly under the root ecn4-extensions folder. . Modify the ECN4 startup command line arguments as follows:
-cp "C:/N4/TEST_Apps\ECN4\lib\n4-ecn4.jar;$INSTALLDIR\extensions\xpsRevertPlan.jar" com.navis.ecn4.Ecn4StandaloneCacheLauncher
Also modify the ecn4_settings.xml file to specify the alternate message component provider eg:
<component name="standardmessage"> <setting name="OPERATION" value="remote"/> <component name="remote"> <!-- AlternateMessageComponentProvider --> <!-- StandardMessageComponentProvider --> <setting name="COMPONENT_PROVIDER" value="com.navis.ecn4.standardmessage.impl.AlternateMessageComponentProvider"/> </component> </component> |
|
Swap Request
|
To rollback to the 21010 Bento: Under ecn4-extensions\sample\xpsRevertPlan, copy the xpsRevertPlan.jar and place it directly under the root of the ecn4-extensions folder. . Modify the ECN4 startup command line arguments as follows: -cp "C:/N4/TEST_Apps\ECN4\lib\n4-ecn4.jar;$INSTALLDIR\extensions\xpsRevertPlan.jar" com.navis.ecn4.Ecn4StandaloneCacheLauncher
Also modify the ecn4_settings.xml file to specify the alternate message component provider eg:
<component name="standardmessage"> <setting name="OPERATION" value="remote"/> <component name="remote"> <!-- AlternateMessageComponentProvider --> <!-- StandardMessageComponentProvider --> <setting name="COMPONENT_PROVIDER" value="com.navis.ecn4.standardmessage.impl.AlternateMessageComponentProvider"/> </component> </component> |
|
TBD unit Merge |
To rollback to 21000 Bento: From the \ecn4-extensions\sample\xpsTbdunitMerge\conf\runtime\xmlrdt folder, copy the XpsMergeTbdUnitStateTransitionEvent.groovy and place it directly under the root ECN4 extensions folder. Also from the ecn4-extensions\sample\xpsTbdunitMerge\conf\runtime\xmlrdt folder copy the state_model_using_xps_merge.xml into the root ECN4 extensions folder. Change the ECN4 settings - like the one under ecn4-extensions\sample\xpsTbdunitMerge\conf\runtime\ecn4_settings.xml so that when ECN4 starts it uses the custom state model ontop of the default statemodel.
<component name="xmlrdt"> <setting name="ENABLED" value="true"/> <setting name="PORT" value="13101"/> <setting name="OUTPUT_VALIDATION" value="true"/> <setting name="JOBLIST_PUSH_DELAY" value="10000"/> <setting name="JOB_UPDATE_PUSH_DELAY" value="1000"/> <setting name="JOB_UPDATE_BLOCKED_CHE_MIN_DELAY" value="500"/> <setting name="JOBSTEP_FORM_TRANSITION_DELAY_ENABLED" value="true"/> <setting name="CONTAINER_LIST_SIZE" value="3"/> <setting name="CONTAINER_LIST_SORT" value="com.navis.ecn4.xmlrdt.impl.sorters.DefaultQuayCraneUnitSort"/> <setting name="DEFAULT_JOBLIST_FILTER" value="com.navis.ecn4.xmlrdt.impl.filters.DefaultJobListFilter"/> <setting name="DEFAULT_JOBLIST_SORTER" value="com.navis.ecn4.xmlrdt.impl.sorters.PriorityJobListSort"/> <setting name="LOCALE" value="en"/> <component name="stateModelFiles"> <setting name="DEFAULT" value="classpath:/xmlrdt/state_model_using_xps_merge.xml"/> <setting name="DEFAULT" value="classpath:/xmlrdt/stateModel.xml"/> </component> <component name="formModelFiles"> <setting name="DEFAULT" value="classpath:/xmlrdt/formModel.xml"/> </component> </component> |
|
Advise TBD Unit Request |
To rollback to sending 20007 Bento requests to XPS, set ARGOBENTO012 (on page 1) to XPS_Server. |
|
Plan TBD Unit Delivery |
To rollback to sending 20008 Bento requests to XPS, set ARGOBENTO013 (PLAN_TBD_UNIT_DELIVERY_BENTO_PROCESSING) (on page 1) to XPS_Server. |
|
Twin Carry |
You cannot rollback 21012 to XPS. |
|
Work Instruction Processing |
To rollback to sending 20005 Bento requests to XPS, set ARGOBENTO011 (WORK_INSTRUCTION_UPDATE_BENTO_PROCESSING) (on page 1) to XPS_Server. |
|
Men Working Requests |
To roll back to sending 20015 Bento requests for Men Working requests, set ARGOBENTO016 (MEN_WORKING_BENTO_PROCESSING) (on page 1) to XPS_Server. |